SIMPLE MOUTH ANIMATOR 1.0
Charles Lecoanet · lecoanet-design.com

======================================================================
FRANÇAIS
======================================================================

Un panneau After Effects qui anime une bouche à partir d'une piste son :
les lèvres s'ouvrent avec la voix, les coins restent épinglés, les dents
et l'intérieur suivent. Avec l'outil d'analyse, la bouche s'arrondit sur
les « O / OU » et s'étire sur les « I / É ».

CONTENU
- Simple_Mouth_Animator.jsx ............ le script (panneau FR / EN / ES)
- Simple_Mouth_Animator_Vowel_Analyzer.html
                                         l'outil d'analyse des voyelles
                                         (s'ouvre dans le navigateur,
                                         rien n'est envoyé en ligne)
- Lady_Mouth.ai ........................ une bouche d'exemple (Illustrator)
- Simple_Mouth_Animation.aep ........... le projet de démo, déjà animé
- voice_sample_lady.mp3 ................ une voix d'exemple en français
- voice_sample_lady_en.mp3 / _es.mp3 ... la même idée en anglais et en
                                         espagnol (voix de synthèse)
- voice_sample_lady_*.csv .............. l'analyse de chaque voix, prête
                                         à importer

INSTALLATION
- Pour l'essayer : Fichier > Scripts > Exécuter le fichier de script…
- Pour l'avoir en panneau ancrable : copiez le .jsx dans le dossier
  Scripts/ScriptUI Panels d'After Effects, relancez After Effects,
  puis menu Fenêtre > Simple_Mouth_Animator.jsx.
- Laissez le fichier .html à côté du .jsx.
- Dans Réglages > Script et expressions, cochez « Autoriser les scripts
  à écrire des fichiers et à accéder au réseau » si After Effects le
  demande.

EN 4 ÉTAPES
1. Importez Lady_Mouth.ai (ou votre bouche) en composition, un calque
   par élément : lèvre haute, lèvre basse, intérieur, dents. Ajoutez la
   voix dans la comp.
2. Onglet Calques : choisissez la piste audio, assignez vos calques,
   cliquez sur « Créer / mettre à jour l'animation ».
3. Onglet Bouche : pour épingler les coins, posez avec l'outil Puppet
   un pin sur chaque commissure et au moins un au centre de chaque
   lèvre, puis recliquez sur Créer.
4. Voyelles : ouvrez le fichier .html, glissez-y la voix, téléchargez
   le CSV, puis onglet Voyelles > « Importer l'analyse des voyelles ».

Tous les réglages sont des curseurs sur le calque « Mouth Control » :
vous pouvez les animer. « Retirer l'animation » enlève tout proprement.

LICENCE
Gratuit, pour vos projets personnels et commerciaux. Merci de ne pas
revendre ni redistribuer le pack : partagez plutôt le lien de l'article.
Fourni tel quel, sans garantie. Enregistrez votre projet avant de lancer
un script.

======================================================================
ENGLISH
======================================================================

An After Effects panel that animates a mouth from a sound track: the
lips open with the voice, the corners stay pinned, the teeth and the
inside follow. With the analyzer, the mouth rounds on "O / OO" and
stretches on "EE / AY".

CONTENTS
- Simple_Mouth_Animator.jsx ............ the script (EN / FR / ES panel)
- Simple_Mouth_Animator_Vowel_Analyzer.html
                                         the vowel analyzer (opens in your
                                         browser, nothing is uploaded)
- Lady_Mouth.ai ........................ a sample mouth (Illustrator)
- Simple_Mouth_Animation.aep ........... the demo project, already animated
- voice_sample_lady.mp3 ................ a sample voice in French
- voice_sample_lady_en.mp3 / _es.mp3 ... the same idea in English and
                                         Spanish (synthetic voices)
- voice_sample_lady_*.csv .............. each voice's analysis, ready to
                                         import

INSTALL
- To try it: File > Scripts > Run Script File…
- As a dockable panel: copy the .jsx into After Effects'
  Scripts/ScriptUI Panels folder, restart After Effects, then
  Window > Simple_Mouth_Animator.jsx.
- Keep the .html file next to the .jsx.
- In Settings > Scripting & Expressions, check "Allow Scripts to Write
  Files and Access Network" if After Effects asks for it.

IN 4 STEPS
1. Import Lady_Mouth.ai (or your own mouth) as a composition, one layer
   per part: upper lip, lower lip, inside, teeth. Add the voice to the
   comp.
2. Layers tab: pick the audio track, assign your layers, click
   "Create / update animation".
3. Mouth tab: to pin the corners, use the Puppet tool to place a pin on
   each corner and at least one in the middle of each lip, then click
   Create again.
4. Vowels: open the .html file, drop the voice on it, download the CSV,
   then Vowels tab > "Import vowel analysis".

Every setting is a slider on the "Mouth Control" layer, so you can
animate them. "Remove animation" cleans everything up.

LICENSE
Free for personal and commercial projects. Please don't resell or
redistribute the pack: share the article's link instead. Provided as
is, without warranty. Save your project before running a script.
